Entrée de Registre Admin Task

Ajouter une Tâche de l'administrateur au module Tâches de l'administrateur. Une tâche d'administration peut être sélectionnée dans le client EMu pour lancer une tâche sur le serveur.

Les Tâches de l'administrateur peuvent être exécutées à partir du client EMu pour réaliser de nombreuses fonctions serveur. Elles peuvent :

  • Exécuter une commande sur le serveur pour modifier des fichiers basés sur le serveur.
  • Lancer un rapport côté serveur et afficher les résultats sur la machine client.
  • Créer un rapport utilisant des données rentrées par l'utilisateur. Une tâche de l’administrateur peut demander à un utilisateur de lui fournir des valeurs qui serviront de variables aux scripts du serveur.

Lorsque Admin est sélectionné dans le Centre de Commandes, la fenêtre Tâches de l'administrateur s'affiche avec une liste de tâches groupées par module, accessibles à l'utilisateur connecté à l'application :

Tâches de l'administrateur

Utilisation

Cette entrée de Registre est attribuée aux utilisateurs et aux groupes :

Clé Utilisateur Groupe Groupe
Clé 1 User Group Group
Clé 2 utilisateur groupe Default
Clé 3 Table
Clé 4 table
Clé 5 Admin Task
Clé 6 tâche
Valeur script
User utilisateur Table table Admin Task tâche script
Group groupe Table table Admin Task tâche script
Group Default Table table Admin Task tâche script

où :

table

identifie le module principal sous lequel le nom de la tâche est listée dans la fenêtre Tâches de l'administrateur. Le format du nom de la table est celui du nom back end (ex. : eparties, emultimedia, etc.), mais il s'affichera dans la fenêtre Tâches de l'administrateur comme le nom du module auquel il correspond.(ex. : Personnes / Organisations, Multimédia).

Un nom de table spécial de eadmin est utilisé pour ajouter des entrées dans le module virtuel Admin.

tâche

est le nom de la tâche telle qu'elle est listée dans la fenêtre Tâches de l'administrateur sous le nom du module.

script

est le script qui est exécuté lorsque tâche est sélectionnée dans la fenêtre Tâches de l'administrateur.

Le format du script est :

{output format} commande

où :
{output format}

spécifie le format du résultat de la tâche de l’administrateur. Par défaut, le résultat s'affichera dans une fenêtre Résultats d'une tâche de l’administrateur. C'est une valeur optionnelle.

Il est possible de préciser la manière dont le résultat généré par une Tâche de l’administrateur est géré. Par défaut, les résultats s'affichent dans la boîte de dialogue Résultats de tâche d'admin et peuvent être sauvegardés et imprimés :

Résultats de tâche de l'administrateur

En spécifiant les options de format de sortie, il est possible d'afficher les résultats d'une tâche de l’administrateur en utilisant les fonctions de reporting standard d'EMu.

Le format de l'option de format est :

{action location options}

où :

action

est l'un(e) des :

Save

Les résultats sont enregistrés dans un fichier et ne sont pas affichés à l'écran.

Dans ce cas location prend la valeur de l'endroit où le fichier doit être sauvegardé.

Il n'y a pas d'options pour cette action.

Launch

Les résultats sont enregistrés dans un fichier à l'emplacement précisé dans la valeur prise par location.

Lorsqu'un résultat est sauvegardé, les options spécifient quel(s) fichier(s) doi(ven)t être lancé(s). L'application qui lance le fichier est celle qui est configurée dans le Registre de Windows pour ce type de fichier.

Les fichiers spécifiés par options peuvent être des chemins codés en dur ou des emplacements de fichiers de la forme %n, où n est le numéro du fichier dans la liste des fichiers sauvegardés. Donc, %1 est le premier fichier sauvegardé, %2 est le second et ainsi de suite. Si un nombre spécifié est plus grand que le nombre de fichiers générés, il est ignoré.

Une fois lancé, un fichier est supprimé du serveur. Utilisez l'option %l pour arrêter la suppression des fichiers générés sur le serveur (note : les fichiers côté client ne sont jamais supprimés).

Utilisez l'option %f reportfile pour lancer un rapport. reportfile est le nom du fichier utilisé pour générer le rapport. Le fichier de rapport est chargé dans un cache sur la machine client et l'option est remplacée par le nom de chemin complet du fichier de rapport mis en cache.

Si un rapport générique est lancé (ex. : un rapport unique utilisé pour plusieurs bases de données), l'option %m module peut être utilisée. Ainsi, tous les fichiers transférés sont envoyés dans le répertoire de rapport (par exemple, eparties), puis le fichier de rapport spécifié est extrait de ce répertoire.

Run

Les résultats sont enregistrés dans un fichier à l'emplacement précisé dans la valeur prise par location.

Lorsque les résultats sont sauvegardés, options définit la commande à exécuter côté client. Toutes les options disponibles pour Launch peuvent être utilisées pour Run.

location

est l'un(e) des :

  
Temp Enregistre un fichier de sortie dans le répertoire des fichiers temporaires de Windows (généralement C:\Winnt\Temp). Le nom de fichier utilisé est le même que celui créé sur le serveur. Il n'y a pas de saisie demandée à l'utilisateur.
ODBC

Enregistre un fichier de sortie sous ODBC Data Source pour le module en cours. Le module en cours est celui pour lequel la tâche de l’administrateur est définie. Il est supposé que le format du fichier est compatible pour l'utilisation de Microsoft ODBC Text Driver.
File

Affiche la fenêtre de Sauvegarder le fichier à chaque fois qu'un fichier est copié depuis le serveur sur le client. Ainsi l'utilisateur peut spécifier où le fichier doit être sauvegardé.
Directory

Lorsque le premier fichier est copié depuis le client sur le serveur, il est demandé à l'utilisateur de spécifier un répertoire où réaliser la sauvegarde. Le nom de fichier utilisé est le même que celui créé sur le serveur.

Note: Les fichiers générés sur le serveur par les tâches de l'administrateur et transférés au client sont effacés du serveur après le transfert.

commande

doit être spécifié. Il s'agit du nom du script à exécuter sur le serveur. La commande doit se trouver dans le répertoire d'administration sur la machine serveur EMu. Il est possible d'inviter l'utilisateur à saisir des données (arguments) qui sont transmises via la commande. Si aucun {format de sortie} n'est fourni, tout résultat généré est affiché dans une fenêtre Résultats de tâche d'admin.
  1. Écrire le script qui sera lancé par la tâche de l’administrateur.
  2. Placez le script sur le serveur EMu dans le répertoire admin avec des autorisations 755.

    Les scripts Tâches de l'administrateur doivent être placés dans le répertoire admin sur le serveur EMu. Ce répertoire fait partie de la configuration PATH standard pour EMu sur le serveur, les noms de chemin absolus ne sont donc pas nécessaires. Les mises à jour d'EMu ne suppriment pas les fichiers se trouvant dans le répertoire admin.

    De plus, emusync ne supprimera pas les commandes client spécifiques trouvées dans le répertoire admin (contrairement aux répertoires bin et utils), mais ajoutera les commandes trouvées dans le client maître. Les Tâches de l'administrateur spécifiques au client (c'est-à-dire les tâches spécifiques à un client donné, par opposition aux tâches génériques) doivent être placées dans le répertoire admin du client.

  3. Créer une entrée de Registre Tâche de l’administrateur pour ajouter la nouvelle tâche au module Admin.

L'exemple suivant est une entrée de Registre qui crée une nouvelle tâche de l’administrateur :

Clé Paramètre Description
Clé 1 Group  
Clé 2 Manager  
Clé 3 Table  
Clé 4 eadmin

Nom de la table sur laquelle la tâche de l’administrateur va s'exécuter.

eadmin devra être utilisé pour toute tâche ne s'appliquant à une table en particulier (par. ex. eparties, emultimedia).
Clé 5 Admin Task

 
Clé 6 List ISO-8859 Characters

Nom de la tâche telle qu'elle sera listée dans la fenêtre Tâches de l'administrateur.
Valeur listchars

Nom du script qui réalise la tâche de l’administrateur.

Cette entrée affichera un rapport Crystal Report listant les enregistrements pouvant être identiques :

Clé Paramètre
Clé 1 Group
Clé 2 Default
Clé 3 Table
Clé 4 eparties
Clé 5 Admin Task
Clé 6 View Duplicate Report
Valeur {Run ODBC Crystal/crystal.exe %f duplicate_a4.rpt}duplicatereport eparties [number:Enter Year] [number: Enter Month] [number:Enter Day]

La tâche View Duplicate Report sera affichée dans le module Admin. dans la rubrique Personnes / Organisations. Lorsque la tâche est sélectionnée :

  1. Une boîte de dialogue s'affichera en demandant une valeur à l'utilisateur.
  2. La valeur saisie par l'utilisateur est donnée au script appelé duplicatereport, qui se situe dans le répertoire admin.
  3. Les résultats du script duplicatereport sont sauvegardés sous ODBC Data Source pour le module eparties.
  4. Crystal/crystal.exe est ensuite exécuté et les résultats sont donnés au script duplicate_a4.rpt pour exécution.
  5. Typiquement le fichier Crystal report utilisera les résultats du script utilisé (duplicatereport dans cet exemple) pour créer un rapport qui sera ensuite visualisable.

Cette entrée est utilisée pour lancer un script clearematchlist sur le serveur qui ne nécessite pas d'entrée de la part de l'utilisateur ou de résultats pour l'utilisateur :

Clé Paramètre
Clé 1 Group
Clé 2 Default
Clé 3 Table
Clé 4 eadmin
Clé 5 Admin Task
Clé 6 Clear Matchlist Database
Valeur clearematchlist